home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / olrdrs / smx330.zip / SMX-PROG.DOC < prev    next >
Text File  |  1993-10-25  |  5KB  |  102 lines
  1. For those of you who'd like to modify the CONFIG.SMX to your liking (and who 
  2. do not yet have a utility to do that) here is a Pascal record of the format 
  3. for the Config file.  
  4.  
  5. Until a decent installation/setup utility is written, it would be best to 
  6. give the information for those who'd like to do some tweaking or customizing. (I've been emphasizing on fixing bugs and enhance-
  7. ments in the older Beta-versions of SigMX rather than writing an elabortate
  8. installation utility.)  Of course, if you have some form of disk- or hex-
  9. editor, you can also modify the cinfiguration file.
  10.  
  11. (Note that in older versions of SigMX the file was called SIGMX.CFG. The
  12.  filename really doesn't matter, and any configuration file after v3.00ß
  13.  should be compatible. If you have the configuration file for SigMX v2.xx,
  14.  you'll have to redo the configuration.)
  15.  
  16. In Pascal, use the following definition:
  17.  
  18. type
  19.   Config = record
  20.              Version: string[10];        (* Version Number           *)
  21.              SigFileName,                (* Path/File of Sig         *)
  22.              TagPhraseFileName,          (* Path/File of TagPhrases  *)
  23.              LastTagLine: string[78];    (* Final TagLine            *)
  24.              Reserved00: byte;           (* Left-over from v3.10ß    *)
  25.              BorderDef: array[1..48]     (* Border Definitions       *)
  26.                           of char;
  27.              Reserved01: byte;           (* Left-over from v3.10ß    *)
  28.              Conversion: array[1..128]   (* ASCII 7/8 bit conversion *)
  29.                           of char;
  30.              Width,                      (* Width of SigBlock        *)
  31.              Height: byte                (* Height of SigBlock       *)
  32.              LastSelected,               (* Last TagPhrase Selected  *)
  33.              ASCII_Toggle: word;         (* 00h=8-bit, 0Ch=7-bit ASC *)
  34.              Colors: array[0..15]        (* Colors                   *)
  35.                           of byte;
  36.            end;
  37.  
  38.  
  39. * Note that string[x] if an array of characters from [0..x], where item[0]
  40.   is the length and items [1..x] are the data. Keep this in mind if you
  41.   are using C instead of Pascal to handle the strings.
  42.  
  43. Please consult your manual on typedef I/O if you don't yet know. Also, make
  44. sure you back-up a copy of the configuration file in case you make a mistake!
  45.  
  46. I suggest leaving the _Version_ string as it is, since it may be used by
  47. future versions of SigMX for updating or converting the CFG or SMX file....
  48.  
  49. _Width_ should be no larger than 78 (especially if Borders are defined!).
  50. However, if should by no means be smaller than the width of the sig you
  51. plan on using.
  52.  
  53. The _Conversion_ string is a string of 128 characters (The length-byte must 
  54. always be set to 128!) used to convert 8-bit IBM-PC ASCII characters to
  55. 7-bit characters.  Thus Conversion[1] is the 7-bit character that ASCII 128
  56. will be changed to, Conversion[2] <--> ASCII 129 etc.
  57.  
  58. The _BorderDef_ string defines the characters used to create the Border: 
  59.  
  60. BorderDef[01] = Left Vertical Character (8-bit)
  61. BorderDef[02] = Middle Vertical Char ("Middle" seperates Sig from TagPhrase)
  62. BorderDef[03] = Right Vertical Char
  63. BorderDef[04] = Top Horizontal Char
  64. BorderDef[05] = Bottom Horizontal Char
  65. BorderDef[06] = Top Left Corner Char
  66. BorderDef[07] = Top Middle Char
  67. BorderDef[08] = Right Top Char
  68. BorderDef[09] = Left Bottom
  69. BorderDef[10] = Middle Bottom
  70. BorderDef[11] = Right Bottom
  71. BorderDef[12] = TagLine Character (FEh is usual)
  72. BorderDef[13..24] equivalent to BorderDef[1..12], only these are the 7-bit
  73.               characters used for Networks (such as FIDO).
  74. BorderDef[25..45] are reserved for later use.
  75. BorderDef[46] = Reserved.
  76. BorderDef[47] = Reserved.
  77. BorderDef[48] = 00h for no border, FFh (255) for Border.
  78.  
  79. The _Colors_ are as follows:
  80.  
  81. Colors[00] = Main Screen Border
  82. Colors[01] = SigBlock Text Preview
  83. Colors[02] = TagPhrase Selection Text
  84. Colors[03] = TagPhrase Highlight
  85. Colors[04] = Dialogue Box
  86. Colors[05] = Help Screen
  87. Colors[06] = View Screen Border
  88. Colors[07] = View Screen Text
  89. Colors[08] = Error Message
  90. Colors[09] = Bottom Status Line Message
  91. Colors[10..15] are reserved for later use.
  92.  
  93. Please note that SigMX assumes that the Sig you use is not too wide and
  94. that the TagPhrase file is not too long, otherwise unforseen consequences
  95. may occur.  If you want to plug in strange values and risk SigMX crashing,
  96. go ahead....it's your copy, on your computer....
  97.  
  98. If you write yourself a decent installation utility, please let me know, and
  99. please feel free to circulate it among other users of SigMX, so long as it
  100. is distributed in a seperate archive.
  101.  
  102.